Sets the pattern to which a window’s content region is redrawn.

OSStatus SetWindowContentPattern (
    WindowRef window, 
    PixPatHandle pixPat
);

Parameter descriptions

window

A pointer to the window whose content pattern is being set.

pixPat

Set this structure to specify the content pattern to be used. This handle is copied by the Window Manager, and your application continues to own the original. Therefore there may be higher RAM requirements for applications with numerous identically patterned windows.

function result

A result code.

DISCUSSION

If your application uses the SetWindowContentPattern function, the window’s content region is redrawn to the pattern you specify, without affecting the value specified in the window’s CGrafPort structure for the current background pattern. .

See also the function GetWindowContentPattern.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)